Within DrawingML, there is the notion of core drawing elements. These are elements that both are vital to and common across the DrawingML framework. These elements denote the most integral pieces of the DrawingML document structure and thus are among the most widely used.

[Note: Measurement Units - Length units shall be expressed in device-independent physical units: English Metric units (EMUs), points, picas, and inches. Device-dependent units such as pixels shall not be used. end note]

This element specifies how to build the animation for a diagram.

[Example: Consider the following example where a chart is specified to be animated by category rather than as one entity. Thus, the bldChart element should be used as follows:

<p:bdldLst>
<p:bldGraphic spid="4" grpId="0">
<p:bldSub>
<a:bldChart bld="category"/>
</p:bldSub>
</p:bldGraphic>
</p:bldLst>

end example]

Parent Elements

bldSub (§4.6.17)

Attributes

Description

animBg (Animate Background)

Specifies whether or not the chart background elements should be animated as well. An example of background elements are grid lines and the chart legend.

The possible values for this attribute are defined by the XML Schema boolean datatype.

bld (Build)

Specifies how the chart will be built. The animation will animate the sub-elements in the container in the particular order defined by this attribute.

The possible values for this attribute are defined by the ST_AnimationChartBuildType simple type (§5.1.12.5).

The following XML Schema fragment defines the contents of this element:

</complexType>

bldDgm (Build Diagram)

This element specifies how to build the animation for a diagram.

[Example: Consider having a diagram appear as on entity as opposed to by section. The bldDgm element should be used as follows:

<p:bdldLst>
<p:bldGraphic spid="4" grpId="0">
<p:bldSub>
<a:bldDgm bld="one"/>
</p:bldSub>
</p:bldGraphic>
</p:bldLst>

end example]

Parent Elements

bldSub (§4.6.17)

Attributes

Description

bld (Build)

Specifies how the chart will be built. The animation will animate the sub-elements in the container in the particular order defined by this attribute.

The possible values for this attribute are defined by the ST_AnimationDgmBuildType simple type (§5.1.12.7).

rev (Reverse Animation)

Specifies whether the animation of the objects in this diagram should be reversed or not. If this attribute is not specified, a value of false is assumed.

The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</complexType>

chart (Chart to Animate)

This element specifies a reference to a chart that should be animated within a sequence of slide animations. In addition to simply acting as a reference to a chart there is also animation build steps defined.

Parent Elements

graphicEl (§4.6.45)

Attributes	Description
bldStep (Animation Build Step)	Specifies which step this part of the chart should be built using. For instance the chart can be built as one object meaning it will be animated as a single graphic. Alternatively the chart can be animated, or built as separate pieces. The possible values for this attribute are defined by the ST_ChartBuildStep simple type (§5.1.12.13).
categoryIdx (Category Index)	Specifies the index of the category within the corresponding chart that should be animated. The possible values for this attribute are defined by the XML Schema int datatype.
seriesIdx (Series Index)	Specifies the index of the series within the corresponding chart that should be animated. The possible values for this attribute are defined by the XML Schema int datatype.

The following XML Schema fragment defines the contents of this element:

</complexType>

cNvCxnSpPr (Non-Visual Connector Shape Drawing Properties)

This element specifies the non-visual drawing properties for a connector shape. These non-visual properties are properties that the generating application would utilize when rendering the slide surface.

Parent Elements

nvCxnSpPr (§5.1.2.1.25)

Child Elements	Subclause
cxnSpLocks (Connection Shape Locks)	§5.1.2.1.11
endCxn (Connection End)	§5.1.2.1.13
extLst (Extension List)	§5.1.2.1.15
stCxn (Connection Start)	§5.1.2.1.36

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

cNvGraphicFramePr (Non-Visual Graphic Frame Drawing Properties)

This element specifies the non-visual drawing properties for a graphic frame. These non-visual properties are properties that the generating application would utilize when rendering the slide surface.

Parent Elements

nvGraphicFramePr (§5.1.2.1.26)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
graphicFrameLocks (Graphic Frame Locks)	§5.1.2.1.19

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

cNvGrpSpPr (Non-Visual Group Shape Drawing Properties)

This element specifies the non-visual drawing properties for a group shape. These non-visual properties are properties that the generating application would utilize when rendering the slide surface.

Parent Elements

nvGrpSpPr (§5.1.2.1.27)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
grpSpLocks (Group Shape Locks)	§5.1.2.1.21

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

cNvPicPr (Non-Visual Picture Drawing Properties)

This element specifies the non-visual properties for the picture canvas. These properties are to be used by the generating application to determine how certain properties are to be changed for the picture object in question.

[Example: Consider the following DrawingML.

<p:pic>
…
<p:nvPicPr>
<p:cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
<p:cNvPicPr>
<a:picLocks noChangeAspect="1"/>
</p:cNvPicPr>
<p:nvPr/>
</p:nvPicPr>
…
</p:pic>

end example]

Parent Elements

nvPicPr (§5.1.2.1.28)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
picLocks (Picture Locks)	§5.1.2.1.31

Attributes

Description

preferRelativeResize (Relative Resize Preferred)

Specifies if the user interface should show the resizing of the picture based on the picture's current size or its original size. If this attribute is set to true, then scaling will be relative to the original picture size as opposed to the current picture size.

[Example: Consider the case where a picture has been resized within a document and is now 50% of the originally inserted picture size. Now if the user chooses to make a later adjustment to the size of this picture within the generating application, then the value of this attribute should be checked.

If this attribute is set to true then a value of 50% will be shown. Similarly, if this attribute is set to false, then a value of 100% should be shown because the picture has not yet been resized from its current (smaller) size. end example]

The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

cNvPr (Non-Visual Drawing Properties)

This element specifies non-visual canvas properties. This allows for additional information that does not affect the appearance of the picture to be stored.

[Example: Consider the following DrawingML.

<p:pic>
…
<p:nvPicPr>
<p:cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
</p:nvPicPr>
…
</p:pic>

end example]

Parent Elements

nvCxnSpPr (§5.1.2.1.25); nvGraphicFramePr (§5.1.2.1.26); nvGrpSpPr (§5.1.2.1.27); nvPicPr (§5.1.2.1.28); nvSpPr (§5.1.2.1.29)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
hlinkClick (Click Hyperlink)	§5.1.5.3.5
hlinkHover (Hyperlink for Hover)	§5.1.2.1.23

Attributes	Description
descr (Alternative Text for Object)	Specifies alternative text for the current DrawingML object, for use by assistive technologies or applications which will not display the current object. If this element is omitted, then no alternative text is present for the parent object. [Example: Consider a DrawingML object defined as follows: <… descr="A picture of a bowl of fruit"> The descr attribute contains alternative text which may be used in place of the actual DrawingML object. end example] The possible values for this attribute are defined by the XML Schema string datatype.
hidden (Hidden)	Specifies whether this DrawingML object shall be displayed. When a DrawingML object is displayed within a document, that object may be hidden (i.e., present, but not visible). This attribute shall determine whether the object shall be rendered or made hidden. [Note: An application may have settings which allow this object to be viewed. end note] If this attribute is omitted, then the parent DrawingML object shall be displayed (i.e., not hidden). [Example: Consider an inline DrawingML object which shall be hidden within the document's content. This setting would be specified as follows: <… hidden="true" /> The hidden attribute has a value of true, which specifies that the DrawingML object is hidden and not displayed when the document is displayed. end example] The possible values for this attribute are defined by the XML Schema boolean datatype.
id (Unique Identifier)	Specifies a unique identifier for the current DrawingML object within the current document. This ID may be used to assist in uniquely identifying this object so that it can be referred to by other parts of the document. If multiple objects within the same document share the same id attribute value, then the document shall be considered non-conformant. [Example: Consider a DrawingML object defined as follows: <… id="10" … > The id attribute has a value of 10, which is the unique identifier for this DrawingML object. end example] The possible values for this attribute are defined by the ST_DrawingElementId simple type (§5.1.12.19).
name (Name)	Specifies the name of the object. [Note: Typically, this will be used to store the original file name of a picture object. end note] [Example: Consider a DrawingML object defined as follows: < … name="foo.jpg" > The name attribute has a value of foo.jpg, which is the name of this DrawingML object. end example] The possible values for this attribute are defined by the XML Schema string datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

cNvSpPr (Non-Visual Shape Drawing Properties)

This element specifies the non-visual drawing properties for a shape. These properties are to be used by the generating application to determine how the shape should be dealt with

[Example: Consider the shape that has a shape lock applied to it.

<p:sp>
<p:nvSpPr>
<p:cNvPr id="2" name="Rectangle 1"/>
<p:cNvSpPr>
<a:spLocks noGrp="1"/>
</p:cNvSpPr>
</p:nvSpPr>
…
</p:sp>

This shape lock is stored within the non-visual drawing properties for this shape. end example]

Parent Elements

nvSpPr (§5.1.2.1.29)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
spLocks (Shape Locks)	§5.1.2.1.34

Attributes

Description

txBox (Text Box)

Specifies that the corresponding shape is a text box and thus should be treated as such by the generating application. If this attribute is omitted then it is assumed that the corresponding shape is not specifically a text box.

[Note: Because a shape is not specified to be a text box does not mean that it cannot have text attached to it. A text box is merely a specialized shape with specific properties. end note]

The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

cxnSp (Connection Shape)

This element specifies a connection shape that is used to connect two sp elements. Once a connection is specified using a cxnSp, it is left to the generating application to determine the exact path the connector will take. That is the connector routing algorithm is left up to the generating application as the desired path might be different depending on the specific needs of the application.

[Example: Consider the following connector shape that connects two regular shapes.

<p:spTree>

…
<p:sp>
<p:nvSpPr>
<p:cNvPr id="1" name="Rectangle 1"/>
<p:cNvSpPr/>
<p:nvPr/>
</p:nvSpPr>
…
</p:sp>
<p:sp>

<p:nvSpPr>
<p:cNvPr id="2" name="Rectangle 2"/>
<p:cNvSpPr/>
<p:nvPr/>
</p:nvSpPr>
…
</p:sp>
<p:cxnSp>

<p:nvCxnSpPr>
<p:cNvPr id="3" name="Elbow Connector 3"/>
<p:cNvCxnSpPr>
<a:stCxn id="1" idx="3"/>
<a:endCxn id="2" idx="1"/>
</p:cNvCxnSpPr>
<p:nvPr/>
</p:nvCxnSpPr>
…
</p:cxnSp>
</p:spTree>

end example]

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
nvCxnSpPr (Non-Visual Properties for a Connection Shape)	§5.1.2.1.25
spPr (Shape Properties)	§5.1.2.1.35
style (Shape Style)	§5.1.2.1.37

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

cxnSpLocks (Connection Shape Locks)

This element specifies all locking properties for a connection shape. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Parent Elements

cNvCxnSpPr (§5.6.2.4); cNvCxnSpPr (§4.4.1.8); cNvCxnSpPr (§5.8.2.3); cNvCxnSpPr (§5.1.2.1.4)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15

Attributes	Description
noAdjustHandles (Disallow Showing Adjust Handles)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeArrowheads (Disallow Arrowhead Changes)	Specifies that the generating application should not allow arrowhead changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeShapeType (Disallow Shape Type Change)	Specifies that the generating application should not allow shape type changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noEditPoints (Disallow Shape Point Editing)	Specifies that the generating application should not allow shape point changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding connection shape. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the generating application should not allow position changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the generating application should not allow shape rotation changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding connection shape. That means also that no picture, shapes or text attached to this connection shape can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

dgm (Diagram to Animate)

This element specifies a reference to a diagram that should be animated within a sequence of slide animations. In addition to simply acting as a reference to a diagram there is also animation build steps defined.

Parent Elements

graphicEl (§4.6.45)

Attributes

Description

bldStep (Animation Build Step)

Specifies which step this part of the diagram should be built using. For instance the diagram can be built as one object meaning it will be animated as a single graphic. Alternatively the diagram can be animated, or built as separate pieces.

The possible values for this attribute are defined by the ST_DgmBuildStep simple type (§5.1.12.18).

id (Identifier)

Specifies the GUID of the shape for this build step in the animation.

The possible values for this attribute are defined by the ST_Guid simple type (§5.1.12.27).

The following XML Schema fragment defines the contents of this element:

</complexType>

endCxn (Connection End)

This element specifies the ending connection that should be made by the corresponding connector shape. This connects the end tail of the connector to the final destination shape.

Parent Elements

cNvCxnSpPr (§5.6.2.4); cNvCxnSpPr (§4.4.1.8); cNvCxnSpPr (§5.8.2.3); cNvCxnSpPr (§5.1.2.1.4)

Attributes

Description

id (Identifier)

Specifies the id of the shape to make the final connection to.

The possible values for this attribute are defined by the ST_DrawingElementId simple type (§5.1.12.19).

idx (Index)

Specifies the index into the connection site table of the final connection shape. That is there are many connection sites on a shape and it must be specified which connection site the corresponding connector shape should connect to.

The possible values for this attribute are defined by the XML Schema unsignedInt datatype.

The following XML Schema fragment defines the contents of this element:

</complexType>

ext (Extension)

This element specifies an extension that is used for future extensions to the current version of DrawingML. This allows for the specifying of currently unknown elements in the future that will be used for later versions of generating applications.

Parent Elements

extLst (§5.1.2.1.15); extLst (§5.9.2.13)

Child Elements	Subclause
Any element from any namespace	n/a

Attributes

Description

uri (Uniform Resource Identifier)

Specifies the URI, or uniform resource identifier that represents the data stored under this tag. The URI is used to identify the correct 'server' that can process the contents of this tag.

The possible values for this attribute are defined by the XML Schema token datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

extLst (Extension List)

This element specifies the extension list within which all future extensions of type ext will be defined. The extension list along with corresponding future extensions is used to extend the storage capabilities of the DrawingML framework. This allows for various new types of data to be stored natively within the framework.

Parent Elements

audioCd (§5.1.3.1); audioFile (§5.1.3.2); backdrop (§5.1.7.2); blip (§5.1.10.13); bodyPr (§5.1.5.1.1); bodyStyle (§4.4.1.5); cell3D (§5.1.6.1); clrMap (§4.4.1.6); clrMap (§5.1.8.1); clrMapOvr (§5.7.2.30); clrScheme (§5.1.8.2); cNvCxnSpPr (§5.6.2.4); cNvCxnSpPr (§4.4.1.8); cNvCxnSpPr (§5.8.2.3); cNvCxnSpPr (§5.1.2.1.4); cNvGraphicFramePr (§4.4.1.9); cNvGraphicFramePr (§5.5.2.4); cNvGraphicFramePr (§5.8.2.4); cNvGraphicFramePr (§5.6.2.5); cNvGraphicFramePr (§5.1.2.1.5); cNvGrpSpPr (§5.1.2.1.6); cNvGrpSpPr (§5.8.2.5); cNvGrpSpPr (§5.6.2.6); cNvGrpSpPr (§4.4.1.10); cNvPicPr (§5.6.2.7); cNvPicPr (§4.4.1.11); cNvPicPr (§5.2.2.2); cNvPicPr (§5.1.2.1.7); cNvPicPr (§5.8.2.6); cNvPr (§5.2.2.3); cNvPr (§5.8.2.7); cNvPr (§4.4.1.12); cNvPr (§5.6.2.8); cNvPr (§5.1.2.1.8); cNvSpPr (§5.1.2.1.9); cNvSpPr (§5.8.2.8); cNvSpPr (§5.6.2.9); cNvSpPr (§4.4.1.13); cxnSp (§5.1.2.1.10); cxnSpLocks (§5.1.2.1.11); defaultTextStyle (§4.3.1.7); defPPr (§5.1.5.2.2); defRPr (§5.1.5.3.2); docPr (§5.5.2.5); endParaRPr (§5.1.5.2.3); font (§5.1.4.2.13); fontScheme (§5.1.4.1.18); graphicFrame (§5.1.2.1.18); graphicFrameLocks (§5.1.2.1.19); gridCol (§5.1.6.2); grpSp (§5.1.2.1.20); grpSpLocks (§5.1.2.1.21); grpSpPr (§5.8.2.14); grpSpPr (§4.4.1.20); grpSpPr (§5.1.2.1.22); grpSpPr (§5.6.2.17); hlinkClick (§5.1.5.3.5); hlinkHover (§5.1.2.1.23); hlinkMouseOver (§5.1.5.3.6); ln (§5.1.2.1.24); lnB (§5.1.6.3); lnBlToTr (§5.1.6.4); lnDef (§5.1.4.1.20); lnL (§5.1.6.5); lnR (§5.1.6.6); lnT (§5.1.6.7); lnTlToBr (§5.1.6.8); lockedCanvas (§5.4.2.1); lstStyle (§5.1.5.4.12); lvl1pPr (§5.1.5.4.13); lvl2pPr (§5.1.5.4.14); lvl3pPr (§5.1.5.4.15); lvl4pPr (§5.1.5.4.16); lvl5pPr (§5.1.5.4.17); lvl6pPr (§5.1.5.4.18); lvl7pPr (§5.1.5.4.19); lvl8pPr (§5.1.5.4.20); lvl9pPr (§5.1.5.4.21); majorFont (§5.1.4.1.24); minorFont (§5.1.4.1.25); notesStyle (§4.4.1.25); objectDefaults (§5.1.8.7); otherStyle (§4.4.1.32); overrideClrMapping (§5.1.8.8); pic (§5.1.2.1.30); picLocks (§5.1.2.1.31); pPr (§5.1.5.2.7); quickTimeFile (§5.1.3.4); rPr (§5.1.5.3.9); scene3d (§5.1.4.1.26); scene3d (§5.9.5.5); sp (§5.1.2.1.33); sp3d (§5.1.7.12); sp3d (§5.9.5.6); spDef (§5.1.4.1.27); spLocks (§5.1.2.1.34); spPr (§5.6.2.29); spPr (§5.7.2.198); spPr (§5.8.2.23); spPr (§5.1.2.1.35); spPr (§4.4.1.41); spPr (§5.9.3.7); spPr (§5.2.2.6); tableStyle (§5.1.6.9); tblPr (§5.1.6.13); tblStyle (§5.1.4.2.26); tc (§5.1.6.14); tcBdr (§5.1.4.2.28); tcPr (§5.1.6.15); tcTxStyle (§5.1.4.2.30); theme (§5.1.8.9); themeElements (§5.1.8.10); titleStyle (§4.4.1.45); tr (§5.1.6.16); txDef (§5.1.4.1.28); txSp (§5.1.2.1.41); uLn (§5.1.5.3.14); videoFile (§5.1.3.6)

Child Elements	Subclause
ext (Extension)	§5.1.2.1.14

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

graphic (Graphic Object)

This element specifies the existence of a single graphic object. Document authors should refer to this element when they wish to persist a graphical object of some kind. The specification for this graphical object will be provided entirely by the document author and referenced within the graphicData child element.

Parent Elements

anchor (§5.5.2.3); graphicFrame (§5.1.2.1.18); graphicFrame (§5.8.2.12); graphicFrame (§5.6.2.15); graphicFrame (§4.4.1.18); inline (§5.5.2.8)

Child Elements	Subclause
graphicData (Graphic Object Data)	§5.1.2.1.17

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

graphicData (Graphic Object Data)

This element specifies the reference to a graphic object within the document. This graphic object is provided entirely by the document authors who choose to persist this data within the document.

[Note: Depending on the type of graphical object used not every generating application that supports the OOXML framework will have the ability to render the graphical object. end note]

Parent Elements

graphic (§5.1.2.1.16)

Child Elements	Subclause
Any element from any namespace	n/a

Attributes

Description

uri (Uniform Resource Identifier)

Specifies the URI, or uniform resource identifier that represents the data stored under this tag. The URI is used to identify the correct 'server' that can process the contents of this tag.

The possible values for this attribute are defined by the XML Schema token datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

graphicFrame (Graphic Frame)

This element specifies the existence of a graphics frame. This frame contains a graphic that was generated by an external source and needs a container in which to be displayed on the slide surface.

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
graphic (Graphic Object)	§5.1.2.1.16
nvGraphicFramePr (Non-Visual Properties for a Graphic Frame)	§5.1.2.1.26
xfrm (2D Transform for Individual Objects)	§5.1.9.6

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

graphicFrameLocks (Graphic Frame Locks)

This element specifies all locking properties for a graphic frame. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Parent Elements

cNvGraphicFramePr (§4.4.1.9); cNvGraphicFramePr (§5.5.2.4); cNvGraphicFramePr (§5.8.2.4); cNvGraphicFramePr (§5.6.2.5); cNvGraphicFramePr (§5.1.2.1.5)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15

Attributes	Description
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding graphic frame. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noDrilldown (Disallow Selection of Child Shapes)	Specifies that the generating application should not allow selecting of objects within the corresponding graphic frame but allow selecting of the graphic frame itself. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding graphic frame. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the corresponding graphic frame cannot be moved. Objects that reside within the graphic frame can still be moved unless they also have been locked. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding graphic frame. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding picture. That means also that no picture, shapes or text attached to this picture can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. [Note: If this attribute is specified to be true then the graphic frame cannot be selected and the objects within the graphic frame cannot be selected as well. That is the entire graphic frame including all sub-parts are considered un-selectable. end note] The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

grpSp (Group shape)

This element specifies a group shape that represents many shapes grouped together. This shape is to be treated just as if it were a regular shape but instead of being described by a single geometry it is made up of all the shape geometries encompassed within it. Within a group shape each of the shapes that make up the group are specified just as they normally would. The idea behind grouping elements however is that a single transform can apply to many shapes at the same time.

[Example: Consider the following group shape.

<p:grpSp>
<p:nvGrpSpPr>
<p:cNvPr id="10" name="Group 9"/>
<p:cNvGrpSpPr/>
<p:nvPr/>
</p:nvGrpSpPr>

<p:grpSpPr>
<a:xfrm>
<a:off x="838200" y="990600"/>
<a:ext cx="2426208" cy="978408"/>
<a:chOff x="838200" y="990600"/>
<a:chExt cx="2426208" cy="978408"/>
</a:xfrm>
</p:grpSpPr>

<p:sp>
…
</p:sp>
<p:sp>
…
</p:sp>

<p:sp>
…
</p:sp>
</p:grpSp>

In the above example we see three shapes specified within a single group. These three shapes have their position and sizes specified just as they normally would within the shape tree. The generating application should apply the transformation after the bounding box for the group shape has been calculated. end example]

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1)

Child Elements	Subclause
cxnSp (Connection Shape)	§5.1.2.1.10
extLst (Extension List)	§5.1.2.1.15
graphicFrame (Graphic Frame)	§5.1.2.1.18
grpSp (Group shape)	§5.1.2.1.20
grpSpPr (Visual Group Shape Properties)	§5.1.2.1.22
nvGrpSpPr (Non-Visual Properties for a Group Shape)	§5.1.2.1.27
pic (Picture)	§5.1.2.1.30
sp (Shape)	§5.1.2.1.33
txSp (Text Shape)	§5.1.2.1.41

The following XML Schema fragment defines the contents of this element:

</choice>

</sequence>

</complexType>

grpSpLocks (Group Shape Locks)

Parent Elements

cNvGrpSpPr (§5.1.2.1.6); cNvGrpSpPr (§5.8.2.5); cNvGrpSpPr (§5.6.2.6); cNvGrpSpPr (§4.4.1.10)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15

Attributes	Description
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the corresponding group shape cannot be grouped. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noMove (Disallow Moving Shape)	Specifies that the corresponding graphic frame cannot be moved. Objects that reside within the graphic frame can still be moved unless they also have been locked. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noResize (Disallow Shape Resizing)	Specifies that the corresponding group shape cannot be resized. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the corresponding group shape cannot be rotated Objects that reside within the group can still be rotated unless they also have been locked. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the corresponding group shape cannot have any part of it be selected. That means that no picture, shapes or attached text can be selected either if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. [Note: This property is inherited by sub-elements and thus all shapes within the group shape cannot be selected when this attribute is set to a value of true. end note] The possible values for this attribute are defined by the XML Schema boolean datatype.
noUngrp (Disallow Shape Ungrouping)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

grpSpPr (Visual Group Shape Properties)

This element specifies the properties that are to be common across all of the shapes within the corresponding group. If there are any conflicting properties within the group shape properties and the individual shape properties then the individual shape properties should take precedence.

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1)

Child Elements	Subclause
blipFill (Picture Fill)	§5.1.10.14
effectDag (Effect Container)	§5.1.10.25
effectLst (Effect Container)	§5.1.10.26
extLst (Extension List)	§5.1.2.1.15
gradFill (Gradient Fill)	§5.1.10.33
grpFill (Group Fill)	§5.1.10.35
noFill (No Fill)	§5.1.10.44
pattFill (Pattern Fill)	§5.1.10.47
scene3d (3D Scene Properties)	§5.1.4.1.26
solidFill (Solid Fill)	§5.1.10.54
xfrm (2D Transform for Grouped Objects)	§5.1.9.5

Attributes

Description

bwMode (Black and White Mode)

Specifies that the group shape should be rendered using only black and white coloring. That is the coloring information for the group shape should be converted to either black or white when rendering the corresponding shapes.

No gray is to be used in rendering this image, only stark black and stark white.

[Note: This does not mean that the group shapes themselves are stored with only black and white color information. This attribute instead sets the rendering mode that the shapes will use when rendering. end note]

The possible values for this attribute are defined by the ST_BlackWhiteMode simple type (§5.1.12.10).

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

hlinkHover (Hyperlink for Hover)

This element specifies the hyperlink information to be activated when the user's mouse is hovered over the corresponding object. The operation of the hyperlink is to have the specified action be activated when the mouse of the user hovers over the object. When this action is activated then additional attributes can be used to specify other tasks that should be performed along with the action.

Parent Elements

cNvPr (§5.2.2.3); cNvPr (§5.8.2.7); cNvPr (§4.4.1.12); cNvPr (§5.6.2.8); cNvPr (§5.1.2.1.8); docPr (§5.5.2.5)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
snd (Hyperlink Sound)	§5.1.2.1.32

Attributes	Description
action (Action Setting)	Specifies an action that is to be taken when this hyperlink is activated. This may be used to specify a slide to be navigated to or a script of code to be run. The possible values for this attribute are defined by the XML Schema string datatype.
endSnd (End Sounds)	Specifies if the URL in question should stop all sounds that are playing when it is clicked. The possible values for this attribute are defined by the XML Schema boolean datatype.
highlightClick (Highlight Click)	Specifies if this attribute has already been used within this document. That is when a hyperlink has already been visited that this attribute would be utilized so the generating application may determine the color of this text. If this attribute is omitted, then a value of 0 or false is implied. The possible values for this attribute are defined by the XML Schema boolean datatype.
history (Add Hyperlink to Page History)	Specifies whether to add this URI to the history when navigating to it. This allows for the viewing of this presentation without the storing of history information on the viewing machine. If this attribute is omitted, then a value of 1, or true is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
id (Drawing Object Hyperlink Target) Namespace: .../officeDocument/2006/relationships	Specifies the relationship id that when looked up in this slides relationship file will contain the target of this hyperlink. This attribute cannot be omitted. The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1).
invalidUrl (Invalid URL)	Specifies the URL when it has been determined by the generating application that the URL is invalid. That is the generating application may still store the URL but it is known that this URL is not correct. The possible values for this attribute are defined by the XML Schema string datatype.
tgtFrame (Target Frame)	Specifies the target frame that is to be used when opening this hyperlink. When the hyperlink is activated this attribute will be used to determine if a new window must be launched for viewing or if an existing one may be used. If this attribute is omitted, than a new window will be opened. The possible values for this attribute are defined by the XML Schema string datatype.
tooltip (Hyperlink Tooltip)	Specifies the tooltip that should be displayed when the hyperlink text is hovered over with the mouse. If this attribute is omitted, than the hyperlink text itself may be displayed. The possible values for this attribute are defined by the XML Schema string datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

ln (Outline)

This element specifies an outline style that can be applied to a number of different objects such as shapes and text. The line allows for the specifying of many different types of outlines including even line dashes and bevels.

Parent Elements

bottom (§5.1.4.2.6); defRPr (§5.1.5.3.2); endParaRPr (§5.1.5.2.3); insideH (§5.1.4.2.14); insideV (§5.1.4.2.15); left (§5.1.4.2.18); lnStyleLst (§5.1.4.1.21); right (§5.1.4.2.22); rPr (§5.1.5.3.9); spPr (§5.6.2.29); spPr (§5.7.2.198); spPr (§5.8.2.23); spPr (§5.1.2.1.35); spPr (§4.4.1.41); spPr (§5.9.3.7); spPr (§5.2.2.6); tl2br (§5.1.4.2.31); top (§5.1.4.2.32); tr2bl (§5.1.4.2.33); whole (§5.9.3.9)

Child Elements	Subclause
bevel (Line Join Bevel)	§5.1.10.9
custDash (Custom Dash)	§5.1.10.21
extLst (Extension List)	§5.1.2.1.15
gradFill (Gradient Fill)	§5.1.10.33
headEnd (Line Head/End Style)	§5.1.10.38
miter (Miter Line Join)	§5.1.10.43
noFill (No Fill)	§5.1.10.44
pattFill (Pattern Fill)	§5.1.10.47
prstDash (Preset Dash)	§5.1.10.48
round (Round Line Join)	§5.1.10.52
solidFill (Solid Fill)	§5.1.10.54
tailEnd (Tail line end style)	§5.1.10.57

Attributes	Description
algn (Stroke Alignment)	Specifies the alignment to be used for the underline stroke. The possible values for this attribute are defined by the ST_PenAlignment simple type (§5.1.12.40).
cap (Line Ending Cap Type)	Specifies the ending caps that should be used for this line. Examples of cap types are rounded, flat, etc. If this attribute is omitted, than a value of square is assumed. The possible values for this attribute are defined by the ST_LineCap simple type (§5.1.12.31).
cmpd (Compound Line Type)	Specifies the compound line type to be used for the underline stroke. If this attribute is omitted, then a value of sng is assumed. The possible values for this attribute are defined by the ST_CompoundLine simple type (§5.1.12.15).
w (Line Width)	Specifies the width to be used for the underline stroke. If this attribute is omitted, then a value of 0 is assumed. The possible values for this attribute are defined by the ST_LineWidth simple type (§5.1.12.35).

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

nvCxnSpPr (Non-Visual Properties for a Connection Shape)

This element specifies all non-visual properties for a connection shape. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a connection shape. This allows for additional information that does not affect the appearance of the connection shape to be stored.

Parent Elements

cxnSp (§5.1.2.1.10)

Child Elements	Subclause
cNvCxnSpPr (Non-Visual Connector Shape Drawing Properties)	§5.1.2.1.4
cNvPr (Non-Visual Drawing Properties)	§5.1.2.1.8

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

nvGraphicFramePr (Non-Visual Properties for a Graphic Frame)

This element specifies all non-visual properties for a graphic frame. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a graphic frame. This allows for additional information that does not affect the appearance of the graphic frame to be stored.

Parent Elements

graphicFrame (§5.1.2.1.18)

Child Elements	Subclause
cNvGraphicFramePr (Non-Visual Graphic Frame Drawing Properties)	§5.1.2.1.5
cNvPr (Non-Visual Drawing Properties)	§5.1.2.1.8

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

nvGrpSpPr (Non-Visual Properties for a Group Shape)

This element specifies all non-visual properties for a group shape. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a group shape. This allows for additional information that does not affect the appearance of the group shape to be stored.

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1)

Child Elements	Subclause
cNvGrpSpPr (Non-Visual Group Shape Drawing Properties)	§5.1.2.1.6
cNvPr (Non-Visual Drawing Properties)	§5.1.2.1.8

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

nvPicPr (Non-Visual Properties for a Picture)

This element specifies all non-visual properties for a picture. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a picture. This allows for additional information that does not affect the appearance of the picture to be stored.

[Example: Consider the following PresentationML.

<p:pic>
…
<p:nvPicPr>
…
</p:nvPicPr>
…
</p:pic>

end example]

Parent Elements

pic (§5.1.2.1.30)

Child Elements	Subclause
cNvPicPr (Non-Visual Picture Drawing Properties)	§5.1.2.1.7
cNvPr (Non-Visual Drawing Properties)	§5.1.2.1.8

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

nvSpPr (Non-Visual Properties for a Shape)

This element specifies all non-visual properties for a shape. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a shape. This allows for additional information that does not affect the appearance of the shape to be stored.

Parent Elements

sp (§5.1.2.1.33)

Child Elements	Subclause
cNvPr (Non-Visual Drawing Properties)	§5.1.2.1.8
cNvSpPr (Non-Visual Shape Drawing Properties)	§5.1.2.1.9

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

pic (Picture)

This element specifies the existence of a picture object within the document.

[Example: Consider the following PresentationML that specifies the existence of a picture within a document. This picture can have non-visual properties, a picture fill as well as shape properties attached to it.

<p:pic>
<p:nvPicPr>
<p:cNvPr id="4" name="lake.JPG" descr="Picture of a Lake" />
<p:cNvPicPr>
<a:picLocks noChangeAspect="1"/>
</p:cNvPicPr>
<p:nvPr/>
</p:nvPicPr>

<p:blipFill>
…
</p:blipFill>

<p:spPr>
…
</p:spPr>
</p:pic>

end example]

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1)

Child Elements	Subclause
blipFill (Picture Fill)	§5.1.10.14
extLst (Extension List)	§5.1.2.1.15
nvPicPr (Non-Visual Properties for a Picture)	§5.1.2.1.28
spPr (Shape Properties)	§5.1.2.1.35
style (Shape Style)	§5.1.2.1.37

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

picLocks (Picture Locks)

Parent Elements

cNvPicPr (§5.6.2.7); cNvPicPr (§4.4.1.11); cNvPicPr (§5.2.2.2); cNvPicPr (§5.1.2.1.7); cNvPicPr (§5.8.2.6)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15

Attributes	Description
noAdjustHandles (Disallow Showing Adjust Handles)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeArrowheads (Disallow Arrowhead Changes)	Specifies that the generating application should not allow arrowhead changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeShapeType (Disallow Shape Type Change)	Specifies that the generating application should not allow shape type changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noCrop (Disallow Crop Changes)	Specifies that the generating application should not allow cropping for the corresponding picture. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noEditPoints (Disallow Shape Point Editing)	Specifies that the generating application should not allow shape point changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding connection shape. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the generating application should not allow position changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the generating application should not allow shape rotation changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding connection shape. That means also that no picture, shapes or text attached to this connection shape can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

snd (Hyperlink Sound)

This element specifies a sound to be played when a hyperlink within the document is activated. This sound is specified from within the parent hyperlink element.

Parent Elements

hlinkClick (§5.1.5.3.5); hlinkHover (§5.1.2.1.23); hlinkMouseOver (§5.1.5.3.6)

Attributes	Description
builtIn (Recognized Built-In Sound)	Specifies whether or not this sound is a built-in sound. If this attribute is set to true then the generating application is alerted to check the name attribute specified for this sound in it's list of built-in sounds and can then surface a custom name or UI as needed. The possible values for this attribute are defined by the XML Schema boolean datatype.
embed (Embedded Audio File Relationship ID) Namespace: .../officeDocument/2006/relationships	Specifies the identification information for an embedded audio file. This attribute is used to specify the location of an object that resides locally within the file. The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1).
name (Sound Name)	Specifies the original name or given short name for the corresponding sound. This is used to distinguish this sound from others by providing a human readable name for the attached sound should the user need to identify the sound among others within the UI. The possible values for this attribute are defined by the XML Schema string datatype.

The following XML Schema fragment defines the contents of this element:

</complexType>

sp (Shape)

This element specifies the existence of a single shape. A shape can either be a preset or a custom geometry, defined using the DrawingML framework. In addition to a geometry each shape can have both visual and non-visual properties attached. Text and corresponding styling information can also be attached to a shape. This shape is specified along with all other shapes within either the shape tree or group shape elements.

[Note: Shapes are the preferred mechanism for specifying text on a slide. end note]

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
nvSpPr (Non-Visual Properties for a Shape)	§5.1.2.1.29
spPr (Shape Properties)	§5.1.2.1.35
style (Shape Style)	§5.1.2.1.37
txSp (Text Shape)	§5.1.2.1.41

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

spLocks (Shape Locks)

This element specifies all locking properties for a shape. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Parent Elements

cNvSpPr (§5.1.2.1.9); cNvSpPr (§5.8.2.8); cNvSpPr (§5.6.2.9); cNvSpPr (§4.4.1.13)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15

Attributes	Description
noAdjustHandles (Disallow Showing Adjust Handles)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeArrowheads (Disallow Arrowhead Changes)	Specifies that the generating application should not allow arrowhead changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noChangeShapeType (Disallow Shape Type Change)	Specifies that the generating application should not allow shape type changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noEditPoints (Disallow Shape Point Editing)	Specifies that the generating application should not allow shape point changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding connection shape. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the generating application should not allow position changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the generating application should not allow shape rotation changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding connection shape. That means also that no picture, shapes or text attached to this connection shape can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.
noTextEdit (Disallow Shape Text Editing)	Specifies that the generating application should not allow editing of the shape text for the corresponding shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the XML Schema boolean datatype.

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

spPr (Shape Properties)

This element specifies the visual shape properties that can be applied to a shape.

Parent Elements

cxnSp (§5.1.2.1.10); lnDef (§5.1.4.1.20); pic (§5.1.2.1.30); sp (§5.1.2.1.33); spDef (§5.1.4.1.27); txDef (§5.1.4.1.28)

Child Elements	Subclause
blipFill (Picture Fill)	§5.1.10.14
custGeom (Custom Geometry)	§5.1.11.8
effectDag (Effect Container)	§5.1.10.25
effectLst (Effect Container)	§5.1.10.26
extLst (Extension List)	§5.1.2.1.15
gradFill (Gradient Fill)	§5.1.10.33
grpFill (Group Fill)	§5.1.10.35
ln (Outline)	§5.1.2.1.24
noFill (No Fill)	§5.1.10.44
pattFill (Pattern Fill)	§5.1.10.47
prstGeom (Preset geometry)	§5.1.11.18
scene3d (3D Scene Properties)	§5.1.4.1.26
solidFill (Solid Fill)	§5.1.10.54
sp3d (Apply 3D shape properties)	§5.1.7.12
xfrm (2D Transform for Individual Objects)	§5.1.9.6

Attributes

Description

bwMode (Black and White Mode)

Specifies that the picture should be rendered using only black and white coloring. That is the coloring information for the picture should be converted to either black or white when rendering the picture.

No gray is to be used in rendering this image, only stark black and stark white.

[Note: This does not mean that the picture itself that is stored within the file is necessarily a black and white picture. This attribute instead sets the rendering mode that the picture will have applied to when rendering. end note]

The possible values for this attribute are defined by the ST_BlackWhiteMode simple type (§5.1.12.10).

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

stCxn (Connection Start)

This element specifies the starting connection that should be made by the corresponding connector shape. This connects the head of the connector to the first shape.

Parent Elements

cNvCxnSpPr (§5.6.2.4); cNvCxnSpPr (§4.4.1.8); cNvCxnSpPr (§5.8.2.3); cNvCxnSpPr (§5.1.2.1.4)

Attributes

Description

id (Identifier)

Specifies the id of the shape to make the final connection to.

The possible values for this attribute are defined by the ST_DrawingElementId simple type (§5.1.12.19).

idx (Index)

The possible values for this attribute are defined by the XML Schema unsignedInt datatype.

The following XML Schema fragment defines the contents of this element:

</complexType>

style (Shape Style)

This element specifies the style information for a shape.

Parent Elements

cxnSp (§5.1.2.1.10); lnDef (§5.1.4.1.20); pic (§5.1.2.1.30); sp (§5.1.2.1.33); spDef (§5.1.4.1.27); txDef (§5.1.4.1.28)

Child Elements	Subclause
effectRef (Effect Reference)	§5.1.4.2.8
fillRef (Fill Reference)	§5.1.4.2.10
fontRef (Font Reference)	§5.1.4.1.17
lnRef (Line Reference)	§5.1.4.2.19

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

sx (Horizontal Ratio)

This element specifies the horizontal ratio for use within a scaling calculation.

Parent Elements

scale (§4.3.2.13)

Attributes

Description

d (Denominator)

Specifies the denominator to be used within the equation.

The possible values for this attribute are defined by the XML Schema long datatype.

n (Numerator)

Specifies the numerator to be used within the equation.

The possible values for this attribute are defined by the XML Schema long datatype.

The following XML Schema fragment defines the contents of this element:

</complexType>

sy (Vertical Ratio)

This element specifies the vertical ratio for use within a scaling calculation.

Parent Elements

scale (§4.3.2.13)

Attributes

Description

d (Denominator)

Specifies the denominator to be used within the equation.

The possible values for this attribute are defined by the XML Schema long datatype.

n (Numerator)

Specifies the numerator to be used within the equation.

The possible values for this attribute are defined by the XML Schema long datatype.

The following XML Schema fragment defines the contents of this element:

</complexType>

txBody (Shape Text Body)

This element specifies the existence of text to be contained within the corresponding shape. All visible text and visible text related properties are contained within this element. There can be multiple paragraphs and within paragraphs multiple runs of text.

Parent Elements

tc (§5.1.6.14); txSp (§5.1.2.1.41)

Child Elements	Subclause
bodyPr (Body Properties)	§5.1.5.1.1
lstStyle (Text List Styles)	§5.1.5.4.12
p (Text Paragraphs)	§5.1.5.2.6

The following XML Schema fragment defines the contents of this element:

</sequence>

</complexType>

txSp (Text Shape)

This element specifies the existence of a text shape within a parent shape. This text shape is specifically used for displaying text as it has only text related child elements.

Parent Elements

grpSp (§5.1.2.1.20); lockedCanvas (§5.4.2.1); sp (§5.1.2.1.33)

Child Elements	Subclause
extLst (Extension List)	§5.1.2.1.15
txBody (Shape Text Body)	§5.1.2.1.40
useSpRect (Use Shape Text Rectangle)	§5.1.2.1.42
xfrm (2D Transform for Individual Objects)	§5.1.9.6

The following XML Schema fragment defines the contents of this element:

</choice>

</sequence>

</complexType>

useSpRect (Use Shape Text Rectangle)

This element specifies that the text rectangle from the parent shape should be used for this text shape. If this attribute is specified then the text rectangle, or text bounding box as it is also called should have the same dimensions as the text bounding box of the parent shape within which this text shape resides.

Parent Elements

txSp (§5.1.2.1.41)

The following XML Schema fragment defines the contents of this element: